home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / dev / c / DrChip1_02.lzh / flist / flist.doc < prev   
Text File  |  1993-10-18  |  3KB  |  88 lines
  1.                Flist v1.12 Copyright 1993 Charles E. Campbell, Jr
  2.               ----------------------------------------------------------
  3.  
  4. Copyright:
  5.  
  6.     This program (flist) and associated documents are copyrighted 1993
  7.     by Charles E. Campbell, Jr, PhD.
  8.  
  9.  
  10. Restrictions:
  11.  
  12.     All rights to flist and its documents are reserved, except for those
  13.     explicitly granted herein.
  14.  
  15.     No representation or warranties are made with respect to the accuracy,
  16.     reliability, performance, or operation of this software, and all such
  17.     use is at your own risk.  The author does not assume any responsiblity
  18.     or liability whatsoever with respect to your use of this software.
  19.  
  20.     Flist may not be included with any commercial product nor may it be
  21.     sold for profit either separately or as part of a compilation without
  22.     the permission of Dr. Charles E. Campbell, Jr.  It may be included in
  23.     non-profit disk collections such as the Fred Fish collection.  It may
  24.     be archived and uploaded to electronic bulletin board systems so long
  25.     as all files remain together and unaltered.  It may be copied to and used on
  26.     individuals' computer systems.
  27.  
  28.  
  29. Author : Dr. Charles E. Campbell, Jr.
  30. Contact: cec@gryphon.gsfc.nasa.gov
  31. Version: 1.12
  32.  
  33.  
  34. Usage:
  35.  
  36.     flist [filename1 [filename2 [filename3...]]
  37.     flist "?"
  38.  
  39.  
  40. Options:
  41.     -c : produce output suitable for inclusion in a comment
  42.     -C : no comments next to prototypes, etc
  43.     -G : only global functions printed (no static)
  44.     -l : include linenumber in comment field
  45.     -m : merge tags with hdrtags if present
  46.     -p : produce prototype declarations without user variables
  47.     -s#: set screenwidth to specified value
  48.     -S : only static functions printed (no global)
  49.     -t : ctags mode: creates a tags file
  50.     -u : produce prototypes with user variables
  51.     -v : print filenames as they're processed
  52.     -x : extern type listing
  53.  
  54. Explanation:
  55.  
  56.     Normal output consists of the files' names and a list of functions contained
  57.     therein (for the C and C++ languages). Flist can accept input from the standard
  58.     input.
  59.  
  60.     Optional forms of output include: <tags> file, prototypes, extern style
  61.     (old K&R), and a form suitable for inclusion in a comment.  One may
  62.     restrict the output to globally accessable functions or to local (static)
  63.     ones.
  64.  
  65.     The "ctags" mode supports both C and C++.  The C++ mode generates
  66.     tags by function name as usual, but will also generate tags of the
  67.     form class::func, class::~class, operatorX, where X is an operator,
  68.     and class::operatorX.
  69.  
  70.     The -m option allows the generation of a <tags> file which will contain
  71.     any tags from the local <hdrtags> file in addition to whatever source code
  72.     files were processed by flist.
  73.  
  74.     The <rdcolor.dat> file should be moved to the s: directory.  Set the
  75.     environment variable
  76.  
  77.        setenv ChipData s:
  78.  
  79.     so that the programs can find it.  The file provides a mapping from color
  80.     names to escape sequences, and it should be fairly obvious as to how to
  81.     modify it to suit your requirements.
  82.  
  83.     The hdrtag program was compiled with Aztec C on an A3000 with the following
  84.     options: CCOPTS=-qf -wp -c2 -f8.
  85.  
  86.     Good luck, and let me know of any problems you encounter, and any attaboys
  87.     will be appreciated :).
  88.